home *** CD-ROM | disk | FTP | other *** search
/ System Booster / System Booster.iso / Backups / BackMan / BackMan.Doc < prev    next >
Text File  |  1996-09-26  |  8KB  |  159 lines
  1.    NAME
  2.     BackMan -- backs up your data.
  3.  
  4.    INPUTS
  5.     DRIVE/K - drive name(s), as DF0:, PC0:, etc.
  6.         Doesn't need trailing colon, but will be truncated at the first
  7.         colon if present (i.e. you could say "DF0:foo" if you really
  8.         wanted to).
  9.  
  10.     DEVICE/K - name of trackdisk-like Exec device (say, scsi.device).
  11.         The device must support the TD_GETGEOMETRY command to work with
  12.         BackMan. Almost any trackdisk-like device will do, but if you get
  13.         unlikely disk sizes it probably lacks full support of the command
  14.         in question (for example, diskspare.device 1.6 will say it can
  15.         hold something like 512 Mb per disk).
  16.  
  17.         However, avoid naming the device itself and stick to the standard
  18.         DOS drive name if possible (DFx: for trackdisk.device, PCx: for
  19.         mfm.device, etc.), because the interface is much more reliable.
  20.  
  21.     SHOW/S - print out complete file catalogs' listings.
  22.         Only selected entries will be shown.
  23.         The LIST option automatically enables SHOW and does nothing else.
  24.  
  25.     NOCOM/S - don't backup/restore file comment.
  26.         Especially useful when restoring files to a MS-DOS® disk or
  27.         partition handled by CrossDOS® (or similar), since the MS-DOS®
  28.         file system doesn't support comments and you would get a "Can't
  29.         set comment" error for every file that has a comment. Can also
  30.         save some memory and disk space if you don't need to backup
  31.         comments and your files have them.
  32.  
  33.         NOTE: this options refers to files' comments, while the next
  34.         refers to the global backup comment. Don't confuse the two.
  35.  
  36.     COM=COMMENT/K - backup comment.
  37.         This comment will be shown every time the backup is read.
  38.  
  39.         By default, the comment will be set to the name of the drawer
  40.         being backed up.
  41.  
  42.    KEYS
  43.     Press CTRL-C to abort BackMan.
  44.     Press CTRL-F to stop (pause) BackMan; press CTRL-F again to restart.
  45.  
  46.    NOTES
  47.     The secondary file list
  48.     ~~~~~~~~~~~~~~~~~~~~~~~
  49.     On backup, BackMan will write the file list twice: once at the
  50.     beginning of the backup and once again at the end. In this way you
  51.     will have a chance of recovering your backup, should the first file
  52.     list be corrupted by chance or by mistake.
  53.  
  54.     On restore, if you insert the last disk of a backup when asked for
  55.     the first, then BackMan will ask you if you want to read the file
  56.     list from that disk: you can safely do so if you want, but you will
  57.     do one disk swap more than if you read the file list from the first
  58.     disk.
  59.  
  60.     Please note that the secondary file list could actually start on the
  61.     last but one disk: in this case BackMan will request the correct
  62.     disk. This can happen because there could be just a little bit of
  63.     space left on the last but one disk, but not enough to contain the
  64.     whole file list, so it will be split between the last two disks.
  65.  
  66.     The secondary file list could actually start on even earlier disks if
  67.     your backup contained an extremely large number of files (more than
  68.     3128 files in the worst case, usually over ten thousands). In this
  69.     case it will span more than two disks.
  70.  
  71.     Existing files
  72.     ~~~~~~~~~~~~~~
  73.     When you are asked for a new file name (if you selected to rename an
  74.     already existing file), you can select the Cancel button of the
  75.     "Enter new name" requester to skip the file in question.
  76.  
  77.     CMD_FORMAT or CMD_WRITE?
  78.     ~~~~~~~~~~~~~~~~~~~~~~~~
  79.     By default BackMan writes data to disk using TD_FORMAT for DOS
  80.     drives, while it will use CMD_WRITE for Exec devices. This behaviour
  81.     is meant to speed up floppy disk operations (TD_FORMAT is quite
  82.     faster than CMD_WRITE on floppy disks), while it is better suited for
  83.     direct writes to hard disks, removables, or non-floppy data storage
  84.     peripherals in general (SyQuest drives and tape drives, for example),
  85.     which sometimes don't like being formatted. However, this logic is
  86.     not perfect, so you can force the use CMD_WRITE by unselecting the
  87.     "Format" checkmark in the configuration window.
  88.  
  89.     BackMan has been tested with trackdisk.device, ramdrive.device,
  90.     mfm.device (as supplied with WB 3.1), diskspare.device (public
  91.     domain, formats standard DD disks to 960 or 984 kb),
  92.     ?compressdisk.device?
  93.  
  94.     NOTE FOR THE NOVICE USER: forget about all this, DON'T try to backup
  95.     your data to hard disks and DON'T use direct Exec device access
  96.     (except as instructed for tape drives) unless you are absolutely sure
  97.     of what you're doing. You could lose the data you're backing up and
  98.     much more by improper use of these options.
  99.  
  100.    WARNINGS
  101.     It is the user's responsibility to prevent any changes to the files
  102.     being backed up in the time interval from when the directory is read
  103.     to when the file is effectively backed up on disk, tape, or whatever.
  104.     Any changes would result in more or less inconsistent data being
  105.     written to the backup, particularly if the file size is changed.
  106.     BackMan will notice changes in file size and abort the backup (no
  107.     recovery would be possible, except rewriting most of the backup from
  108.     the beginning), but other, although less relevant, changes to the
  109.     file attributes will deliberately go unnoticed.
  110.  
  111.     If you are really really paranoid, I'd suggest to make a backup copy
  112.     of the first and/or last backup disks, because these two disks
  113.     contain the main and secondary file lists: in this way you will be
  114.     more protected against corruption of said lists, without whom it is
  115.     impossible to restore the backup.
  116.  
  117.     BackMan can't handle backups of more than about 2 gigabytes of data.
  118.     But then, is there anybody out there who backs up 2 Gb in a single
  119.     shot? ;) (If you're curious, it would take over 2383 DD disks...)
  120.  
  121.     diskspare.device has proven to be not very reliable when used through
  122.     the DEVICE option, so please avoid using it in this way and stick to
  123.     DRIVE after mounting the appropriate DOS driver.
  124.  
  125.    ESOTERIC SUGGESTIONS
  126.     If you want to transfer data between two nearby computers without
  127.     setting up some kind of network and you choose BackMan, you don't
  128.     need to do the whole backup: you need just one disk, though it would
  129.     be better to have a couple more so you can backup on one computer and
  130.     restore on the other at the same time. Simply start BackMan on both
  131.     computers, and move the disks from one computer to the other as soon
  132.     as they're finished. You have to set the "Ignore contents" option on
  133.     the computer that is doing the backup, otherwise it will reject the
  134.     disks because they belong to the current backup.
  135.  
  136.    NO WARRANTY
  137.     THERE IS NO WARRANTY, EITHER EXPRESSED OR IMPLIED, AS TO THE QUALITY
  138.     OR PERFORMANCE OF THIS PROGRAM. THE ENTIRE RISK FOR THE USE OF THIS
  139.     PROGRAM IS ASSUMED BY THE USER (YOU). THE AUTHORS MAY NOT BE HELD
  140.     RESPONSIBLE FOR ANY LOSS OR CORRUPTION OF DATA, EQUIPMENT OR OTHER
  141.     GOODS RESULTING BY THE USE OR POSSESSION OF THIS PROGRAM, EVEN IF IN
  142.     KNOWLEDGE THAT SUCH LOSS OR CORRUPTION MIGHT HAPPEN.
  143.  
  144.     However, the authors dedicated themselves to ensure that the program
  145.     will behave very likely as described in this manual and that it does
  146.     not contain evident flaws. It has been continuously and thoroughly
  147.     tested throughout development, and it has proven to be reliable in
  148.     everyday use. The authors are willing to maintain the program and
  149.     correct misbehaviours, though they cannot make any promises on this.
  150.  
  151.     In other words, we did our best to write a reliable backup program
  152.     and in fact we rely on it enough to use it for our very own backups,
  153.     but we wrote enough programs to know that there is always another
  154.     bug, no matter how good the programmer is. Be careful the first times
  155.     you try a program like this, which will be responsible of keeping
  156.     your data safe, and start using it for important backups only after
  157.     you've acquired a certain feeling on it.
  158.  
  159.